home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Almathera Ten Pack 3: CDPD 3
/
Almathera Ten on Ten - Disc 3: CDPD3.iso
/
fish
/
751-760
/
752
/
toolmanager
/
docs
/
tm_svenska.doc
< prev
next >
Wrap
Text File
|
1995-03-18
|
40KB
|
1,200 lines
ToolManager 2.0 Dokumentation
*****************************
Upphovsrätt och andra legaliteter
*********************************
Copyright (C) 1990-92 Stefan Becker
Härmed ges tillstånd att kopiera och distribuera ordagranna kopior
av denna manual så länge som denna textsektion finns med i alla kopior.
Jag lämnar ingen garanti av något slag att programmen som beskrivs i
detta dokument är 100% pålitliga. Du använder materialet på egen risk.
Programmeraren *kan inte* göras ansvarig för någon skada som uppkommer
på grund av dessa program.
Paketet är fritt distribuerbart men fortfarande upphovsrättsskyddat av
Stefan Becker. Det betyder att du får kopiera det fritt men du får inte
ta mer betalt än en minimal kopieringsavgift. Denna avgift *får inte*
vara högre än 5USD eller 5DM.
* Denna begränsning gäller även Tyska PD-handlare!! *
Tillstånd ges att inkludera paketet i PD-samlingar, särskilt då
Fred Fish Amiga Disk Bibliotek (Även CD-ROM versioner av det).
Distributionsfilerna får laddas upp på BBS:er eller FTP servers.
Vill du distribuera programmet *måste* du använda en av de två
ursprungliga arkivformerna: 'ToolManager2_0.lha' eller
'ToolManager2_0(Bin|Src).lha'.
Inga program, källkod, eller delar därav, får användas i kommersiella
program utan skrivet tillstånd från programmeraren.
*Inga* program, källkod, eller delar därav, får användas på en maskin
som används för forskning, utveckling, konstruktion, test eller
produktion av vapen eller andra militära ändamål. Detta inkluderar
naturligtvis även alla maskiner som används för träning eller
utbildning av personer att utföra någon av dessa handlingar.
Viktiga anteckningar
********************
Välkommen till ToolManager 2.0s underbara värld. :-)
- Sedan den senaste versionen (1.5) har ToolManager och dess koncept
drastiskt ändrats (Se Historia).
- Från och med 2.0 har programmet nu en *GiftWare* möjlighet.
Tycker du om programmet och använder det väldigt ofta borde du
fundera på att skicka en liten gåva för att visa att du uppskattar
arbetet som programmeraren har lagt ner på det här programmet.
Jag föreslår en donation på omkring 10-20USD eller 10-20DM.
Skicka inte checkar eller sånt från länder utanför Europa, ofta
kostar de mer att lösa ut än värdet på dem.
Om du inte skickar en donation, eller inte har råd med det, så
behöver du inte känna dig usel för det. Men skicka gärna ett vykort
och berätta att du använder ToolManager (Jag tycker om att få post).
Se Programmerarens adress.
- Användare av ToolManager 1.x kan börja med avsnittet om Snabb
installation. En del saker är desamma och resten är ganska lätt att
lista ut genom att prova sig fram. För en detaljerad beskrivning av
det nya konceptet och de nya möjligheterna kan ni titta i
referensavsnittet (Se Objekt).
Ni *måste* ta bort en eventuell ToolManager 1.x, annars fungerar inte
den nya versionen. Version 2.0 kan inte läsa gamla konfigurationsfiler
(Sorry).
- Förstagångsanvändare bör läsa hela dokumentet för att förstå
programmets koncept och syfte. Börja med Introduktion.
- ToolManager 2.0 använder en del funktioner som finns i nästa version
av AmigaOS (Refereras som V38 i detta dokument), som förhoppningsvis
är tillgängligt för de flesta Amigaanvändarna under namnet 2.1 vid
det här laget. Om du fortfarande använder Release 2.0 (Refereras som
V37), behöver du inte oroa dig eftersom ToolManager inte kräver dessa
extra funktioner.
Alla extra V38-funktioner är utmärkta i detta dokument.
Programmerarens adress
**********************
Programmeraren kan nås på följande adresser:
Post:
Stefan Becker
Holsteinstrasse 9
5100 Aachen
TYSKLAND
InterNet Elektronisk Post, E-Mail:
stefanb@pool.informatik.rwth-aachen.de
Snabb installation
******************
En grundläggande installation av ToolManager 2.0 består av följande
fyra delar:
'Libs/toolmanager.library' => 'LIBS:'
Huvudprogrammet. Det hanterar alla program, menyer, symboler och dockor.
(Se Gränssnitt...).
'Prefs/ToolManager*' => 'SYS:Prefs'
Editerar inställningarna (Se Inställningar).
'Utilities/ToolManager*' => 'SYS:WBStartup'
Startar och stoppar ToolManager. Om den ligger i lådan WBStartUp så
startas alltid ToolManager när din WorkBench startas upp.
'L/WBStart-Handler' => 'L:'
Startar program på samma sätt som WorkBench. Det är en separat process
så du kan avsluta ToolManager även om du har program igång som startades
från ToolManager.
Efter att du har kopierat dessa filer bör du avsluta en eventuell äldre
version av ToolManager som är igång på din maskin och dubbelklicka på
ToolManagers symbol i lådan WBStartUp. Nu kan du starta upp
Prefs/ToolManager och börja leka med den (Använd knappen 'Testa' istället
för 'Använd' medan du provar olika inställningar). De flesta funktionerna
borde gå att lista ut efter några försök, men behöver du mer information
kan du titta i objektbeskrivningarna (Se Objekt).
Vad är ToolManager?
*******************
ToolManager är ett flexibelt program som hanterar verktygen i din
arbetsmiljö. Det kan starta program från WorkBench och CLI likväl som ARexx
script. Användargränssnittet består av menyer, symboler eller dockfönster.
Tycker du om en dator som för oväsen kan du koppla ett ljud till vart och
ett av dessa objekt (Se Ljudobjekt).
ToolManager kan lägga till objekt till Workenchens meny 'Tools' eller
'Verktyg'. Om du väljer ett sådant Menyobjekt kommer programmet som det
länkats till att startas. Varje vald symbol på Workbenchen kommer att
användas som argument till programmet. Detta fungerar bara då Workbenchen
är igång (Se Menyobjekt).
ToolManager kan lägga till symboler till Workbenchfönstret. När du
dubbelklickar på en sådan symbol startas programmet som länkats till den.
Släpper du en eller flera symboler på denna symbol kommer programmet att
startas med dessa andra symboler som argument (Se Symbolobjekt).
ToolManager kan skapa ett dockfönster med en samling av program.
Fönstret kan öppnas på varje allmän skärm. Varje program representeras av
en bild eller en knapp. För att starta ett program klickar du bara på dess
bild eller knapp EN gång. Om dockfönstret har öppnats på Workbenchen kan
du även släppa en eller flera symboler på bilden eller knappen för att ge
dessa som argument till programmet (Se Dockobjekt).
Dessutom kan du koppla ett direktval till varje program. Om du trycker den
definierade tangentkombinationen startas programmet. Notera att du *inte*
kan skicka argument till programmet om det startas på detta sätt
(Se Programobjekt).
Konceptet bakom ToolManager
***************************
ToolManager 2.0 använder en ny objekt-orienterad uppläggning för att ge
ett flexibelt och expanderbart system. Detta synsätt har möjliggjort flera
betydande förbättringar sedan ToolManager 1.x, du kan t.ex. ha fler än en
docka nu.
Ett objekt är en samling data som beskriver dess egenskaper. Varje objekt
har ett namn och en typ. Du kan skapa så många objekt av varje typ som du
vill, men varje objektnamn måste vara unikt eftersom det används för att
referera till objektet.
Just nu finns det sex olika typer av objekt: Program, Bild, Ljud, Meny,
Symbol och Docka. De första tre är basobjekt. Det betyder att de inte
refererar till andra objekt utan de förser de andra objekten med data
eller tjänster.
De tre andra objekten är komplexa objekt. De refererar basobjekt och är
beroende av dessa för att komma åt data eller tjänster. Referensen sker
via namnet och om inget objekt med det namnet existerar kommer det
komplexa objektet att ignorera det. Notera att detta kan reducera ett
komplext objekts användbarhet; om t.ex. ett Symbolobjekt behöver data
från ett Bildobjekt som inte finns, skapas ingen symbol.
Se Objekt för en detaljerad beskrivning av alla objekts parametrar.
Beskrivning av alla distribuerade filer
***************************************
Paketet ToolManager 2.0 består av flera kataloger och filer som beskrivs
nedan. Notera att den kompletta distributionen beskrivs här, även om du
kanske har fått den i två separata delar.
Katalogen Docs
==============
Denna katalog innehåller ToolManagers dokumentation.
Den finns tillgänglig i tre format och ett flertal språk.
Dessutom finns en fil i AutoDoc-format som beskriver gränssnittet mot
ToolManagers delade bibliotek.
Prefix 'TM_Språk'
Denna fil innehåller dokumentationen för det givna språket.
Tillgängliga språk är: Engelska och Svenska.
Suffix '.doc'
Denna fil innehåller dokumentationen i ren ASCII text.
Suffix '.dvi'
Denna fil innehåller dokumentationen i TeX DVI format.
Kör du denna fil genom en TeX skrivardrivrutin får du ut en skriven
manual.
Suffix '.guide'
Denna fil innehåller dokumentationen i AmigaGuideformat. Även om den
är i ren ASCII med några kommandon behövs AmigaGuide för att utnyttja
hypertextlänkarna i den. Programmeraren hoppas att AmigaGuide görs
tillgänglig för alla Amigaanvändare snart.
Suffix '.tex'
Denna fil innehåller dokumentationen i Texinfoformat, som det
specificerats av Free Software Foundation (FSF). Tillsammans med
macropaketet 'texinfo.tex' kan du använda TeX och 'texindex' för att
skapa en fil i DVIformat (Se ovan).
'toolmanager.doc'
Den här filen innehåller dokumentationen för gränssnittet mot
ToolManagers delade bibliotek i Autodocformat.
Katalogen Goodies
=================
Denna katalog innehåller extra programpaket som kan vara behjälpliga
när man använder ToolManager.
'upd1_20.lha'
Programmet 'upd' skrevs av Jonas Petersson. Det är ett litet program
som öppnar en ARexxport och väntar på kommandon. Via ARexx kan du
sedan låta 'upd' spela upp samplade ljud. ToolManager använder denna
egenskap för att implementera Ljudobjekt (Se Ljudobjekt).
Katalogen Graphics
==================
Den här katalogen innehåller en rik samling av bilder från vilken du
kan välja dina favoriter. Ladda in dem i ToolManager som Bildobjekt
(Se Bildobjekt).
Dessa filer har gjorts av ett flertal olika personer (Se Tack).
Var och en av dem har en egen underkatalog i distributionen.
Eftersom de kommer från olika håll kommer de från olika miljöer
(palett, djup, upplösning, storlek) och har olika designstilar så en
del kan se mindre bra ut på din maskin.
För att särskilja bildformaten som ToolManager stödjer har varje fil
ett beskrivande suffix:
'.anmb'
Detta är en IFF ANIM fil som skapats av ett rit/animationsprogram.
Den kan innehålla flera bilder.
'.brush'
Detta är en IFF ILBM fil som skapats av ett ritprogram.
Den kan bara innehålla en bild.
'.info'
Detta är en normal Amigasymbol som skapats av IconEdit (Eller liknande).
Den kan innehålla en eller två bilder.
Katalogen L
===========
Denna katalog innehåller bara en enda fil, 'WBStart-Handler'. Du *måste*
kopiera den här filen till katalogen L: (SYS:L), annars kan inte
ToolManager starta program från WorkBench (Se Programobjekt).
Det kompletta WBStart 1.0-paketet finns på Fish Disk # 572.
Katalogen Libs
==============
Denna katalog innehåller bara en enda fil, 'toolmanager.library'.
Det är ToolManagers huvudprogram och *måste* kopieras till katalogen LIBS:
(SYS:Libs).
Katalogen Locale
================
Den här katalogen innehåller alla filer för ToolManagers Locale-stöd.
Eftersom Locale är nytt i och med V38 behöver du inte kopiera dessa filer
om du använder V37. Använder du V38 bör du välja de filer som hör till det
svenska språket och kopiera dem till lämpligt ställe i Locale:
'Catalogs/svenska/toolmanager.catalog'
Detta är en översättningsfil till Svenska. Kopiera den till katalogen
'LOCALE:Catalogs/svenska'.
'Languages/<språk>.language'
Inte alla språk stöds av Commodores standard V38 distribution så en
del av översättarna har skickat med en egen '.language'-fil så att
ToolManager kan använda deras översättningsfiler. Kopiera lämplig fil
till katalogen 'LOCALE:Languages'. Tillgängliga språk är Finska (soumi)
och Eefeler plattyska (eifel).
Katalogen Prefs
===============
Här ligger inställningseditorn och dess symbolfil.
Kopiera båda filerna till katalogen 'SYS:Prefs'.
För utförligare beskrivning av editorn hänvisar jag till sektionen
Inställningar.
Katalogen Programmers
=====================
Denna katalog innehåller alla filer som krävs av diverse
programmeringsspråk och deras kompilatorer för att utnyttja gränssnittet
mot ToolManagers delade bibliotek. Se i katalogen 'examples' för en del
exempel på hur man ska använda det. För en komplett beskrivning
rekommenderas filen 'Docs/toolmanager.doc'.
Stödda programspråk är: AmigaOberon, DICE C, MANX Aztec C och SAS C.
Katalogen Scripts
=================
Den här katalogen innehåller en samling ARexx och Shell script som kan
användas i ToolManagers Programobjekt. Notera att de kan vara specifika
för programmerarens miljö så du kan tvingas att modifiera dem.
Katalogen Source
================
Här ligger den kompletta källkoden till ToolManager och de tillhörande
programmen. Varje program har sin egen underkatalog. Programmeraren skickar
med källkoden som ett exempel på hur man ska programmera under OS 2.0.
Underkatalogen 'locale' är intressant för översättare. Om ditt språk inte
stöds av ToolManager så kan du fylla i tomrummen i filen 'empty.ct' och
skicka till mig så inkluderas den kanske i nästa release.
Katalogen Utilities
===================
Här finns bara ett program, 'ToolManager'. Det startar och stoppar
ToolManager 2.0. Oftast ligger programmet i katalogen WBStartup, men den
kan även köras från Shell.
Användare av ToolManager 1.5 undrar kanske varför programmet 'DeleteTool'
saknas. Jo, därför att programmet 'BlackHole' på Fish disk #662 klarar
jobbet bättre, använd det istället.
ToolManager objekt referenser
*****************************
Det här kapitlet beskriver ToolManagers objekt i detalj. Varje objekt har
en typ och ett namn. Namnet används för att referera till objektet.
Det finns sex olika typer av objekt.
Programobjekt
=============
Programobjekt beskriver program som startas av ToolManager.
Tre olika typer av program stöds: CLI, Workbench och ARexx.
Varje Programobjekt tar följande argument:
(Förvalt värde inom parenteser)
'Argument' (Ja)
Kontrollerar om argumenten ska skickas till programmet eller inte.
Om ett program inte hanterar argument eller bara inte behöver dem kan
du slå av dem.
'Kommando'
Filnamnet på programmet som ska köras. Kan vara relativt till den
aktuella katalogen.
'Aktuell Katalog' ('SYS:')
Namnet på programmets aktuella katalog. Notera att ARexx-program
ignorerar detta.
'Fördröjning' (0)
Efter att man har aktiverat ett Programobjekt så väntar ToolManager i
'fördröjning' sekunder innan programmet startas. Om värdet är negativt
så startas programmet igen efter 'fördröjning' sekunder. För att
stoppa ett Programobjekt i vänteläge behöver du bara aktivera det igen.
Notera att om 'fördröjning' är satt kommer programmet att startas utan
argument.
'Programtyp' (CLI)
Specificerar typ av program. Kan vara en av: CLI, WB eller ARexx.
'Direktval'
Du kan ställa in ett direktval för varje Programobjekt. Om rätt
tangentsekvens skrivs in startas programmet. Notera att programmet
startas utan argument.
'Utdatafil' ('NIL:')
Filnamnet som eventuell utdata skickas till. Endast användbart för
CLI-program.
'Sökväg' (sökväg från ToolManagers process)
Denna sträng sätter programmets sökväg. Du kan specificera flera
kataloger genom att separera dem med ett semikolon, ";".
Endast användbart för CLI-program.
'Prioritet' (0)
Ställer prioriteten på den nya process som kör programmet.
'Allmän Skärm' (förvald allmän skärm)
Du kan ställa namnet på den allmänna skärm som ska flyttas fram innan
programmet startas. Fungerar bara i samband med parametern 'Framåt'.
'Stack' (4096)
Ställer stackens storlek för den nya process som kör programmet.
'Framåt' (Nej)
Om du sätter den här parametern till 'Ja' så flyttas den allmänna
skärm som specificerats i 'Allmän Skärm' längst fram innan programmet
startas.
Bildobjekt
==========
Bildobjekt specificerar bilddatat som ToolManager använder för symboler
eller dockor. Den här objekttypen tar bara ett argument:
'Filnamn'
Det specificerar namnet på filen som ToolManager ska läsa bilddatat
ifrån. ToolManager försöker automagiskt se vilken typ av fil det är:
1. ToolManager försöker ladda in den som en IFF-fil. ToolManager kan
för tillfället läsa två sorter, ILBM (en bild) eller ANIM
(två eller flera bilder).
2. ToolManager laddar in den som en symbolfil. Den kan ha en eller
två bilder.
För tillfället stöds animationer bara i Dockobjekt. Symbolobjekt tar
bara de två första bilderna i en animation för att bygga upp symbolen.
Om du vill göra en animation att använda i ToolManager bör du följa
dessa designregler:
Bild 1
Bör vara en bild som visar det icke aktiva läget.
Bild 2
Bör vara en bild som visar det aktiva, eller valda läget.
Normalt är det en färgvänd kopia av bild 1.
Bild 3 till N-1
Bilder i animationen. Varje bild visas i en tredjedels sekund.
Bild N
Den sista bilden i animationen visas en sekund.
Efter det visas bild 1 igen.
Ljudobjekt
==========
Ett Ljudobjekt kan användas för att låta ToolManager föra oväsen.
ToolManager har ingen egen möjlighet att spela upp ljud utan den använder
ARexx för att aktivera en extern ljuduppspelare, 'upd'.
Denna objekttyp tar två argument:
'Kommando'
Sätter ARexxkommandot som ToolManager skickar för att aktivera
den externa ljuduppspelaren. För 'upd' kan det bli nåt i stil med
'file samples:boing', som instruerar 'upd' att spela upp samplingen
'samples:boing'. Se Godsaker.
'ARexxport'
Specificerar ARexxporten dit ToolManager ska skicka kommandot till.
Förvalt värde är 'PLAY' som är 'upd's port.
Menyobjekt
==========
Menyobjekt kontrollerar vad som ska finnas i Workbenchens Verktygsmeny.
Objektets namn används som texten i menyn. För att aktivera ett sånt
här objekt väljer man det bara i menyn på vanligt sätt.
Menyobjekt fungerar bara när Workbenchen är igång.
Denna objekttyp tar två argument:
'Programobjekt'
Detta är namnet på det Programobjekt som ska aktiveras när
menyalternativet väljs. Alla symboler som är valda just då
används som argument till programmet.
'Ljudobjekt'
Namnet på ett Ljudobjekt som ska aktiveras när menyalternativet väljs.
Att notera för användare av ToolManager 1.x: För att simulera den
gamla verktygstypen 'Dummy' behöver du bara skapa ett Menyobjekt utan
att ange något Program- eller Ljudobjekt.
Symbolobjekt
============
Symbolobjekt beskriver programsymboler i Workbenchfönstret.
Ett Symbolobjekt kan aktiveras genom att man dubbelklickar på symbolen
eller att man släpper en eller flera andra symboler på den.
Symbolobjekt fungerar bara med Workbenchen igång.
Denna objekttyp tar följande argument:
(Förinställda värden inom parenteser)
'Programobjekt'
Namnet på det Programobjekt som ska aktiveras när symbolen väljs.
Alla symboler som släpps på programsymbolen skickas som argument
till programmet.
'Bildobjekt'
Namnet på det Bildobjekt som används för att bygga symbolen.
'Vänsterkant' (0)
Placerar vänsterkanten på symbolen.
'Visa Namn' (Ja)
Om denna parameter är satt till 'Ja' kommer objektnamnet att skrivas
ut som namnet på symbolen.
'Ljudobjekt'
Namnet på ett Ljudobjekt som ska aktiveras när symbolen väljs.
'Överkant' (0)
Placerar symbolens övre kant.
Notera att Workbenchen är *väldigt* noga med var symbolerna placeras.
Om du ger koordinater som Workbenchen inte tycker om kommer de att
ignoreras och symbolen placeras någon annanstans.
Dockobjekt
==========
Dockobjekt beskriver fönster. Dessa fönster kan innehålla flera verktyg
som representeras av bilder eller textknappar. För att starta ett sådant
verktyg behöver du bara klicka på dess bild/knapp EN gång. Du kan även
släppa en eller flera symboler på den för att skicka dessa symboler som
argument till programmet.
Varje Dockobjekt har flera parametrar:
(Förvalda värden inom parenteser)
'Aktiverat' (Ja)
Ett dockfönster kan vara aktivt (öppet) eller inaktivt (stängt).
'Centrerad' (Nej)
Om den här parametern är satt kommer fönstret alltid att vara
centrerad under muspekarens aktuella position när det öppnas.
'Kolumner' (1)
Ställer antalet verktygskolumner i fönstret. Verktygen sorteras alltid
radvis med början i den vänstra kolumnen.
'Typsnitt' (Skärmtypsnitt)
Om du har en docka med parametern 'Text' satt kan du välja vilket
typsnitt textknapparna ska ha.
'Främst' (Nej)
Med denna parameter satt kommer dockfönstret att öppnas på den
allmänna skärm som ligger längst fram.
'Direktval'
Du kan definiera ett direktval för varje Dockobjekt. Om inställd
direktvalssekvens genereras kommer dockans aktiva status att ändras.
Om dockfönstret är öppet kommer det att stängas, och tvärtom.
'Vänsterkant' (0)
Placerar dockfönstrets vänsterkant.
Om parametern 'Centrerad' är satt ignoreras denna parameter.
'Meny' (Nej)
Du kan välja om dockfönstret ska ha en egen liten meny.
Den menyn har två val:
* 'Stäng Docka' Stänger dockfönstret.
* 'Avsluta TM' Avslutar ToolManager.
'Mönster' (Nej)
Dockfönstret justerar sin storlek automagiskt efter den största bilden.
Mindre bilder centreras i fönstret och omges med en tom ram.
Vill du hellre ha den ramen fylld med ett mönster så kan du sätta
den här parametern till 'Ja'.
'Hoppa Fram' (Nej)
Om den här parametern sätts kommer dockfönstret att stängas efter
att ett verktyg valts. Det är särskilt bra i samband med parametrarna
'Centrerad', 'Främst' och ett direktval med klassen 'rawmouse'
(Se Direktval).
'Allmän Skärm' (Förvald allmän skärm)
Den allmänna skärm som dockan ska öppnas på. Skärmen kommer att
flyttas längst fram när dockfönstret öppnas.
Denna parameter ignoreras om parametern 'Främst' är satt.
'Text' (Nej)
Du kan välja mellan bilder och textknappar i dockfönstren med den
här parametern. Textknapparna är särskilt användbara i samband med
parametern 'Hoppa Fram'.
'Titel'
Specificerar dockfönstrets titel. Om du ger en titel kommer fönstret
att bli ett normalt fönster med titelrad, stängknapp, djupknapp
och en ram. Om du *inte* ger en titel kommer dockfönstret bara
att ha en titelrad, ingen ram.
'Överkant' (0)
Positionerar dockfönstrets överkant. Om parametern 'Centrerad' är
satt ignoreras denna parameter.
'Vertikal' (Nej)
Om dockfönstret har det nya utseendet (Bara en titelrad, ingen ram)
så ställer denna parameter om titelraden ska vara horisontell
eller vertikal. Denna parameter ignoreras om du har gett en
fönstertitel med parametern 'Titel'.
ToolManagers förvalseditor
**************************
Med förvalseditorn kan du ställa in ToolManagers globala konfiguration.
Dessa inställningar laddas automagiskt när ToolManager startas.
För att starta editorn behöver du bara dubbelklicka på dess symbol,
du kommer då att se huvudfönstret.
Huvudfönstret
=============
Huvudfönstret har flera olika grupper av knappar och listor:
Objekttyp
Med den här knappen kan du välja vilken typ av objekt som du vill
skapa eller ändra.
Objektlista
Här visas en lista på alla objekt av aktuell typ som finns just nu.
Du kan välja ett objekt genom att klicka på dess namn. Om du
dubbelklickar öppnas ett editorfönster.
Flytta objekt
När du valt ett objekt kan du flytta omkring det i listan med
de här knapparna. Om du klickar på knappen 'Sortera' kommer
objekten i listan att sorteras alfabetiskt.
Manipulera objekt
De här knapparna ändrar objekt. Du kan skapa ett nytt objekt av
aktuell typ genom att trycka på 'Nytt...', editera valt objekt
genom att trycka på 'Ändra...', kopiera valt objekt genom att
trycka på 'Kopiera' eller radera det valda objektet med 'Ta Bort'.
Konfiguration
Du har flera möjligheter att spara inställningarna.
Med knappen 'Spara' kan du spara dem permanent till filen
'ENVARC:ToolManager.prefs'. Vill du bara ändra tillfälligt bör du
använda knappen 'Använd'. Knappen 'Avbryt' går ur editorn utan att
spara ändringarna.
Huvudfönstrets menyer
=====================
Huvudfönstret har flera menyalternativ:
'Projekt'
Med menyvalen 'Öppna...' och 'Spara Som...' kan du ladda eller spara
inställningarna. 'Om...' öppnar en dialogruta med information.
Väljer du 'Avsluta' så avslutas editorn utan att inställningarna
sparas.
'Ändra'
Här kan du återställa gamla konfigurationer. Du får tillbaka de
inställningar som sparades senast med 'Senast Sparade' och du kan
hämta de inställningar som gällde innan du startade editorn med
'Återställ'. Senast sparade hämtas från 'ENVARC:ToolManager.prefs'
medan den återställda kommer från 'ENV:ToolManager.prefs'.
'Inställningar'
'Skapa Symboler' ställer om 'Spara Som...' ska spara ner en symbol
till konfigurationsfilen eller inte.
Editorfönster
=============
Alla objekttyper har ett eget editorfönster för att ställa in objektens
parametrar. Se Objekt för en detaljerad lista över objektparametrarna.
Varje editorfönster har ett textfält för objektnamnet. Det här namnet
är viktigt eftersom det används för att referera till objektet.
Notera att det inte finns någon korsreferens inbyggd, så om du ändrar
namnet på ett objekt som redan används av ett annat objekt så uppdateras
*inte* den referensen. Du måste göra det för hand.
Knapparna i editorfönstren öppnar olika typer av dialogrutor. Du kan
välja en sak genom att klicka på den och sedan på 'OK' eller genom att
helt enkelt dubbelklicka på den. För att lämna en dialogruta utan att
göra några ändringar trycker du bara på 'Avbryt'. Om du önskar att
rensa ett fält som bara tillåter val genom en dialogruta kan du kalla
fram dialogrutan och trycka på 'OK' *utan* att välja något.
Editorfönstren för objekttyperna Program och Bild har en extra egenskap.
Du kan helt enkelt släppa en symbol på dem för att sätta parametrarna
för den symbolen.
Gränssnitt till ToolManagers delade bibliotek
*********************************************
Hanteringen av ToolManager är inbäddat i ett standard Amiga delat
bibliotek. Detta bibliotek erbjuder flera funktioner för att skapa
och manipulera ToolManagers objekt så att du kan använda dem i dina
egna program.
För närvarande finns det sex funktioner att tillgå:
'AllocTMHandle()'
För att kunna skapa ToolManagerobjekt så måste du först allokera
ett TMHandle. Det här handtaget lagrar all information om dina objekt
och används för att referera till dem. Notera att informationen som
lagrats i handtaget är *bara* åtkomligt ifrån det program som skapat
det.
'FreeTMHandle()'
Den här funktionen frigör ett TMHandle och alla ToolManagerobjekt
som kopplats till det. Varje 'AllocTMHandle()' måste följas av ett
'FreeTMHandle()'!
'CreateTMObjectTags()'
'CreateTMObjectTagList()'
De här funktionerna skapar ett ToolManagerobjekt. Du måste ge ett
namn, objekttypen och diverse 'tags' för objektparametrarna.
Objektets namn är viktigt eftersom det används för att referera
till objektet.
'ChangeTMObjectTags()'
'ChangeTMObjectTagList()'
Du kan modifiera ett objekts parametrar med de här funktionerna.
Objektet kommer att uppdateras till de nya värdena.
Notera att Bildobjekt *inte* kan modifieras ännu.
'DeleteTMObject()'
Med den här funktionen kan du radera ett objekt. Om objektet är
länkat till andra objekt kommer de att modifieras på lämpligt sätt.
'QuitToolManager()'
Den här funktionen säger till ToolManagers hanterare att avsluta så
snart som möjligt.
Komplett dokumentation för bibliotekets gränssnitt finns att tillgå
på Engelska i AutoDoc-format (Se katalogen Docs).
Hur man definierar ett direktval
********************************
Detta kapitel berättar hur man definierar ett direktval som en sträng
som beskriver inmatning (Input Description String) som sedan tolkas av
Commodities. Varje gång som ett direktval aktiveras så genererar
Commodities en händelse som ToolManager använder för att aktivera
Programobjekt eller Dockobjekt. Denna sträng har följande utseende:
[<klass>] {[-][<modifierare>]} [-][upstroke] [<tangentkod>]
Det spelar ingen roll om du använder VERSALER eller gemena.
'klass' beskriver typen av händelse (InputEvent). Denna parameter
kan utelämnas, i vilket fall klassen 'rawkey' används.
(Se Klasser av InputEvent)
Modifierare är 'signaler' som måste vara sanna eller falska när
direktvalet aktiveras, annars kommer ingenting att hända. Du ger ett
nyckelord för varje modifierare som måste vara sann. Alla andra
modifierare antas vara falska. Om du vill ignorera en modifierare
skriver du ett minustecken '-' framför dess nyckelord.
Se även listan på modifierare nedan.
Normalt sett genereras en direktvalshändelse när en tangent trycks ner.
Om det istället ska genereras när tangenten släpps upp ger man
nyckelordet 'upstroke'. Om det ska genereras både när tangenten trycks
ner och släpps upp används '-upstroke'.
Tangentkoden är beroende av klassen av InputEvent. Se Tangentkoder.
OBS: Välj dina direktval med omsorg eftersom Commodities har väldigt hög
prioritet i inmatningskedjan och kan 'hinna före' direktval som redan
specificerats i applikationsprogram och liknande.
Klasser av InputEvent
=====================
Commodities stödjer de flesta händelser som kan komma från input.device,
enheten som hanterar all inmatning. Den här delen av dokumentationen
beskriver kort de händelserna som är mest användbara i samband med
direktval för ToolManager.
rawkey
Detta är den förvalda klassen och den täcker in alla tangentbords-
händelser. 'rawkey a' eller 'a' genererar en händelse så fort som
tangenten "a" trycks ner. Du måste specificera en tangentkod för
den här klassen. Se Tangentkoder.
rawmouse
Den här klassen beskriver allt som händer med musknapparna.
Du måste ge en tangentkod för den här klassen. Se Tangentkoder.
diskinserted
Händelser av den här klassen genereras när en diskett trycks in
i diskettstationen. Denna klass har inga tangentkoder.
diskremoved
Händelser av den här klassen genereras när en diskett tas ut ur
diskettstationen. Denna klass har inga tangentkoder.
Modifierare
===========
En del synonymer till nyckelord lades till i V38 av Commodities.
De är utmärkta med en asterisk '*'.
'lshift', 'left_shift' *
Vänster Shift-tangent.
'rshift', 'right_shift' *
Höger Shift-tangent..
'shift'
Någon Shift-tangent, vilken som helst.
'capslock', 'caps_lock' *
Tangenten 'Caps Lock (Shiftlås).
'caps'
En Shift-tangent eller Caps Lock.
'control', 'ctrl' *
Tangenten 'Ctrl' (Control).
'lalt', 'left_alt' *
Vänster Alt-tangent.
'ralt', 'right_alt' *
Höger Alt-tangent.
'alt'
Någon Alt-tangent.
'lcommand', 'lamiga' *, 'left_amiga' *, 'left_command' *
Vänster C=/Amiga/Kommando-tangent.
'rcommand', 'ramiga' *, 'right_amiga' *, 'right_command' *
Höger Amiga/Kommando-tangent.
'numericpad', 'numpad' *, 'num_pad' *, 'numeric_pad' *
Detta nyckelord *måste* ges för varje tangent som ligger på det
numeriska tangentbordet.
'leftbutton', 'lbutton' *, 'left_button' *
Vänster musknapp. Se notis nedan.
'midbutton', 'mbutton' *, 'middlebutton' *, 'middle_button' *
Mitten musknapp för 3-knapps möss. Se notis nedan.
'rbutton', 'rightbutton' *, 'right_button' *
Höger musknapp. Se notis nedan.
'repeat'
Denna modifierare är satt om tangentbordets repetition är aktivt.
Bara användbart för klassen 'rawkey'.
OBS: V37 av Commodities har ett fel som omöjliggör användandet av
'leftbutton', 'midbutton' och 'rbutton' som modifierare.
Felet är åtgärdat i V38.
Tangentkoder
============
Varje klass har sina egna tangentkoder:
Tangentkoder för 'rawkey'
-------------------------
En del nyckelord och synonymer lades till i V38 av Commodities.
Dessa är utmärkta med en asterisk, '*'.
'a'-'z', '0'-'9', ...
ASCII-tecken.
'f1', 'f2', ..., 'f10', 'f11' *, 'f12' *
Funktionstangenter.
'up', 'cursor_up' *, 'down', 'cursor_down' *
'left', 'cursor_left' *, 'right', 'cursor_right' *
Piltangenter.
'esc', 'escape' *, 'backspace', 'del', 'help'
'tab', 'comma', 'return', 'space', 'spacebar' *
Speciella tangenter.
'enter', 'insert' *, 'delete' *
'page_up' *, 'page_down' *, 'home' *, 'end' *
Tangenter på det numeriska tangentbordet. Alla dessa måste användas
tillsammans med modifieraren 'numericpad' eller 'numpad'.
Tangentkoder för 'rawmouse'
---------------------------
Dessa nyckelord lades till i V38 av Commodities.
De är inte tillgängliga under V37.
'mouse_leftpress'
Vänster musknapp nedtryckt.
'mouse_middlepress'
Mittenknappen nedtryckt.
'mouse_rightpress'
Höger musknapp nedtryckt.
OBS: För att använda en av dessa tangentkoder måste du också sätta
motsvarande modifierare, t.ex:
rawmouse leftbutton mouse_leftpress
Exempel på direktval
====================
'ralt t'
Håll nere höger Alt-tangent och tryck ner "t".
'ralt lalt t'
Håll nere båda Alt-tangenterna och tryck ner "t".
'alt t'
Håll nere en av Alt-tangenterna och tryck ner "t".
'rcommand f2'
Håll nere höger Amiga-tangent och tryck ner den andra
funktionstangenten.
'numericpad enter'
Tryck ner 'Enter'-tangenten på det numeriska tangentbordet.
'rawmouse midbutton leftbutton mouse_leftpress'
Håll ner musknappen i mitten och tryck ner den vänstra musknappen.
'diskinserted'
Sätt in en diskett i en diskettstation.
ToolManagers historia
*********************
2.0, släppt 920926
- Helt nytt objektorienterat koncept
- Nästan helt omskriven
- Uppdelat i två delar
- Huvudprogrammet inbäddat i ett delat bibliotek
- Konfigurationen handhas av ett Preferences-program
- Konfigurationen filformat har ändrats igen. :-) Det är nu en
IFF-fil som ligger i ENV:
- Flera dockor samt dockor med flera kolumner
- Nytt utseende på dockfönstren
- Dockorna känner automagiskt av den största bildens storlek
- Ljudstöd
- Direkt ARexx-stöd för Programobjekt
- ToolManager kan köras utan Workbench. Om Workbench inte kör
kommer inga App* funktioner att användas
- Stöd för olika språk genom locale.library
- CLI-verktyg kan använda Workbenchens sökväg
- Separat process för att starta Workbenchprogram
1.5, släppt 911010, Fish Disk #551
- Statusfönstret har 'New/Open/Append/Save As' för konfigurationsfilen
i menyn
- Editorfönstret har fildialogrutor
- Lade till ett dockfönster (à la NeXT)
- Lade till DeleteTool
- Alla aktiva direktval kan visas i en lista
- Verktyg kan flyttas runt i listan
- Lade till symbolpositionering i editorfönstret
- Programsymbolens namn kan sättas
- CLI-verktyg kan ha en utdatafil och en lista på sökvägar
- Använder UserShell för CLI-verktyg
- Maximala längden på kommandoraden för CLI-verktyg är nu 4096 tecken
- Stöd för AppIcons utan namn
- Om du öppnar statusfönstret kommer Workbenchen att flyttas främst
- Workbenchskärmen kan flyttas främst innan ett verktyg startas med
direktval
- ToolManager väntar upp till 20 sekunder på workbench.library
- Lade till en DELAY-parameter som låter ToolManager vänta <num>
sekunder innan någon App*-funktion läggs till
- Döpte om några parametrar
- Förbättrade utseendet
- Några interna ändringar
1.4, släppt 910709, Fish Disk #527
- Direktval för verktyg
- Appsymboler för verktyg
- Möjlighet att slå av menyval
- Konfigurationsfilens format ändrat
- ReadArgs() sköter nu tolkningen av kommandoraden
- Status och editfönstren uppdaterade med nya funktioner
- Säkerhetskoll innan programmet avslutas
- Menyvalet 'Open TM Window' visas bara om programsymbolen är
bortkopplad
- Ändrad startmetod för WB. Stöder projektsymboler
- Flera interna ändringar
1.3, släppt 910313, Fish Disk #476
- Stöder flera konfigurationsfiler
- Konfigurationsfilens format lite ändrat
- Verktygsdefinitionerna kan ändras under körning
- Stöder CLI och Workbench startmetoder
- Valda syboler skickas med som parametrar
- Använder startupsymbolen som programsymbol om den startades
från Workbench
- Symbolens position kan läggas in i konfigurationsfilen
- Programsymbolen kan kopplas bort
- Nytt menyval: 'Show TM Window'
- Varje ny startad ToolManager skickar sina startup-parametrar till
den ToolManager process som redan kör
1.2, släppt 910112, Fish Disk #442
- Statusfönstret ändrat till ett no-GZZ och simple refresh (Borde
spara ett par byte)
- Statusfönstret kommer ihåg sin senaste position
- Ny knapp i statusfönstret, 'Save Configuration' som sparar den
aktuella verktygslistan till konfigurationsfilen
- Små fel borttagna i ListViews knapphantering
- Symbolens namn hårdkodat till 'ToolManager'
1.1, släppt 910101
- Symboler kan släppas på statusfönstret
- Statusfönstret innehåller en lista på alla verktygsnamn
- Man kan ta bort verktyg från listan
1.0, släppt 901104
- Första släppta versionen
Programmeraren vill tacka...
*************************
ToolManager har genomgått många stora förändringar sedan den först
implementerades i mitten av 1990. Denna utveckling hade varit omöjlig
om jag inte fått en sådan enorm respons från de som använde ToolManager.
Många idéer och funktioner kommer från denna källa...
Därför skulle jag vilja tacka:
För Alpha/Beta testning, idéer & bug rapporter:
Amigasektionen av vår lokala datorklubb (Computerclub an der RWTH
Aachen), Olaf 'Olsen' Barthel, Georg Hessmann (Gucky), Markus
Illenseer (ill), Klaus Melchior, Rickard Olsson (Richie), Matthias
Scheler (Tron), Ralph Schmidt (laire), Roger Westerlund (Budda),
Brian Wright (SteveVai) och många andra...
Matthew Dillon
Utan DICE, ditt *excellenta* utvecklingssystem för C samt diverse
andra verktyg skulle inte ToolManager finnas!
För deras utmärkta grafikarbete:
Andreas Harrenberg, Georg Hessmann, Michael "Mick" Hohmann, Markus
Illenseer, Oliver Koenen, Klaus Melchior, Rickard Olsson, Jan
Peter, Matthias Scheler, Brian Wright
För översättningarna av Locale:
Tomi Blinnikka (Finska), Dr. Peter Kittel (Tyska), Klaus Melchior
(Eifel Plattyska), Rickard Olsson (Svenska), Marc Schaefer (Franska
& Italienska)
Alla grabbar och tjejer i West Chester:
För att ni utvecklat Amigan och dess superba operativsystem.
Alla användare som skickat mig pengar:
Jag bad inte om det, men det är skönt att se att någon uppskattar
ens arbete.
Alla användare som skickat mig ett meddelande:
Jag tyckte verkligen om att läsa era brev!
Och tack alla jag glömde nämna...